---
title: Despliega tu sitio Astro en Azion
description: Cómo desplegar tu sitio Astro en la web usando Azion.
sidebar:
  label: Azion
type: deploy
logo: azion
supports: ['ssr', 'static']
i18nReady: true
---
import { Steps } from '@astrojs/starlight/components';

Puedes desplegar tu proyecto Astro en [Azion](https://console.azion.com/), una plataforma para que los desarrolladores frontend colaboren y desplieguen sitios web estáticos (JAMstack) y SSR.

## Prerrequisitos

Para comenzar, necesitarás:

- Una [cuenta de Azion](https://www.azion.com/). Si no tienes una, puedes registrarte para obtener una cuenta gratuita.
- El código de tu aplicación almacenado en un repositorio de [GitHub](https://github.com/).
- [Azion CLI](https://www.azion.com/en/documentation/products/azion-cli/overview/) instalado para una configuración y despliegue de proyectos más rápidos.

## Cómo desplegar a través del panel de la consola de Azion

Para comenzar a construir, sigue estos pasos:

<Steps>
1. Accede a la [Consola de Azion](https://console.azion.com).
2. En la página de inicio, haz clic en el botón **+ Crear**.
   - Esto abre un modal con las opciones para crear nuevas aplicaciones y recursos.
3. Selecciona la opción **Importar desde GitHub** y haz clic en la tarjeta.
   - Esta acción abre la página de configuración.
4. Conecta tu cuenta de Azion con GitHub.
   - Aparecerá una ventana emergente solicitando autorización.
5. Selecciona el repositorio que deseas importar desde GitHub.
6. Configura los ajustes de construcción:
   - **Preajuste de framework:** Selecciona el framework apropiado (por ejemplo, `Astro`).
   - **Directorio raíz:** Se refiere al directorio en el que se encuentra tu código. Tu código debe estar ubicado en el directorio raíz, no en un subdirectorio. Aparece un símbolo ./ en este campo, lo que indica que es un directorio raíz.
   - **Comando de instalación:** el comando que compila tu configuración para construir para producción. Los comandos de construcción se ejecutan a través de scripts. Por ejemplo: npm run build o npm install para un paquete NPM.
7. Haz clic en **Guardar y desplegar**.
8. Monitorea el despliegue usando **Métricas en tiempo real de Azion** y verifica que tu sitio esté en vivo en el borde.
</Steps>

## Cómo desplegar un sitio estático usando Azion CLI

<Steps>
1. **Instala Azion CLI:**
   - Descarga e instala [Azion CLI](https://www.azion.com/en/documentation/products/azion-cli/overview/) para una gestión y despliegue más sencillos.

   :::caution
   Azion CLI no admite actualmente entornos nativos de Windows. Sin embargo, puedes usarlo en Windows a través del Subsistema de Windows para Linux (WSL). Sigue la [guía de instalación de WSL](https://docs.microsoft.com/en-us/windows/wsl/install) para configurar un entorno Linux en tu máquina Windows.
   :::

2. **Autentica la CLI:**
   - Ejecuta el siguiente comando para autenticar tu CLI con tu cuenta de Azion.

   ```bash
   azion login
   ```

3. **Configura tu aplicación:**
   - Usa los siguientes comandos para inicializar y configurar tu proyecto:

   ```bash
   azion init
   ```

4. **Construye tu proyecto Astro:**
   - Ejecuta tu comando de construcción localmente:

   ```bash
   azion build
   ```

5. **Despliega tus archivos estáticos:**
   - Despliega tus archivos estáticos usando Azion CLI:

   ```bash
   azion deploy
   ```
</Steps>

Esta guía proporciona una visión general del despliegue de aplicaciones estáticas.

## Habilitar el desarrollo local usando Azion CLI

Para que la vista previa funcione, debes ejecutar el siguiente comando:

```bash
azion dev
```

Una vez que hayas inicializado el servidor de desarrollo local, la aplicación pasa por el proceso `build`.

```bash
Construyendo tu aplicación Edge. Este proceso puede tardar unos minutos
Ejecutando el comando del paso de construcción:
...
```

Luego, cuando la construcción esté completa, se solicita el acceso a la aplicación:

```bash
[Azion Bundler] [Servidor] › ✔ éxito Función ejecutándose en el puerto http://localhost:3000
```

## Solución de problemas

### APIs de tiempo de ejecución de Node.js

Un proyecto que utiliza un paquete NPM falla en la construcción con un mensaje de error como `[Error] Could not resolve "XXXX. The package "XXXX" wasn't found on the file system but is built into node.":`

Esto significa que un paquete o importación que estás utilizando no es compatible con las APIs de tiempo de ejecución de Azion.

Si estás importando directamente una API de tiempo de ejecución de Node.js, consulta la [compatibilidad de Azion Node.js](https://www.azion.com/en/documentation/products/azion-edge-runtime/compatibility/node/) para obtener más información sobre cómo resolver esto.

Si estás importando un paquete que importa una API de tiempo de ejecución de Node.js, consulta con el autor del paquete para ver si admite la sintaxis de importación `node:*`. Si no lo hacen, es posible que necesites encontrar un paquete alternativo.
